Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / pcopy1.arc / PCOPY.DOC < prev next >

Wrap

Text File | 1988-05-29 | 40.9 KB | 1,105 lines

P C O P Y by Norm Patriquin Version 7.5 May 1988 Patriquin's BBS 714-369-9766 Copyright 1987 by Norm Patriquin Table of Contents General Description . . . . . . . . . . . . . . . . . . . . . . . . 1 About PCOPY . . . . . . . . . . . . . . . . . . . . . . . . . 2 Features: . . . . . . . . . . . . . . . . . . . . . . . . 2 Command Mode Parameters . . . . . . . . . . . . . . . . . . . 4 Specification of default parameters . . . . . . . . . . . . . . . . 10 Examples: . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Program Maintenance: . . . . . . . . . . . . . . . . . . . . . 12 Registering PCOPY . . . . . . . . . . . . . . . . . . . . . . . . . 17 PCOPY Registration . . . . . . . . . . . . . . . . . . . . . . . . 18 Problems and Maintenance . . . . . . . . . . . . . . . . . . . . . 19 2 General Description PCOPY is a DOS command utility used to copy files between disks and directories on disks. In addition to just copying files, PCOPY also allows selection criteria to be specified to better qualify the files to be copied. PCOPY provides a safer way to copy files than is provided by the DOS COPY command. It warns you if a file is about to be overlaid and lets you have complete control over the copy operation. PMOVE is a DOS command utility used to move files between disks and directories on disks. PMOVE combines the functions of DOS COPY and DELETE commands to make moving files very easy. In addition to just moving files, PMOVE also allows selection criteria to be specified to better qualify the files to be moved. PMOVE automatically determines the environment the move is requested for and then determines if the data must be moved or if the file can be moved by renaming. Moving with rename is allowed if the move is to another directory on the same disk device. If a rename move can be done, it is much faster than moving the data, it helps to keep from fragmenting disk free space, and allows very large files to be moved between directories when they could not normally be moved with DOS COPY because of insufficient space. For the remaining part of this documentation we will refer to the program as PCOPY. Remember that the only difference between PCOPY and PMOVE is that PMOVE removes the file from the source location after it has been successfully copied to the desired location. 1 About PCOPY PCOPY is developed to allow standard DOS wildcard pathnames in the source file specifications, and standard pathnames for the target directory specification. PCOPY attempts to anticipate your needs and help you accomplish your task. For instance, if PCOPY determines that the target directory name does not exist, it will ask you if it is to be created. If you respond <YES>, the directory will be created for you. With the /SAve option, if you are about to overlay another file with a duplicate name, you will be asked if the older duplicate file is to be renamed with a version number. PCOPY keeps you out of trouble. If it saves you from overlaying a needed file just once it has paid for itself. Think of all the times it might have saved you in the past. I have tried to develop PCOPY with all the features normally needed for this kind of utility. I hope you find what you need and that the utility is of use to you. For an immediate command summary, enter the PCOPY command without any parameters. Help panels will be displayed. Features: ** Copies files to and from any disk or directory. ** Allows you to save older versions of files with new names before replacing them. ** Moves files by copying them or renaming them to the new location. ** Deletes the original file if /X is specified. ** Creates target directories if needed. ** Makes sure the DOS archive flag is set correctly for each file as it is moved. ** Preserves the DOS date and time for each file moved. ** Allows user to pause processing at any time by pressing any keyboard key. Once stopped, the program can be terminated by pressing <ESCAPE>. ** Provides file selection and processing control options to tailor the move process to your own needs. 2 ** Allows commands to be tested so you may be sure that commands are specified as you desire. ** Copy updated files to a special disk or directory. ** If there is not sufficient space on the current target disk, PMOVE will allow you to place another disk in the drive and continue processing. This allows you to easily move groups of files larger than disk size to other computers. ** Start with a specific file in a directory. ** End with a specific file in a directory. ** Process files based on the date stored in its directory entry. ** Warns you before overlaying a file unless specific parameters indicating otherwise are specified. ** Checks target disk for available space before starting to copy files. This prevents time from being wasted when the copy will not be able to complete. ** Gives you constant status of the progress of the command. ** Runs with windows or using standard DOS screen output. ** Format new floppy disks as they are needed by pressing <F3> at any prompt. ** Process one directory, a single directory subtree or all directories on a disk (/S). ** Allows you to indicate that multiple input disks are to be used and prompts for the next one after each disk is processed. ** Create a series of output disks filled efficiently with files from the source location. 3 Command Mode Parameters PCOPY allows several command parameter switches to be specified to qualify the copy criteria. All these parameters are optional. The PCOPY command is used like DOS COPY except for these switches. The command format and switch parameters are described below. A quick review of command parameters is always available by entering the PCOPY command without any parameters. COMMAND FORMAT: PCOPY from_file_spec [to_file_spec] [ (/ switches) ] [from} Enter the DOS file specification for the directory and file names to be moved. The filename portion of the file specification may contain wildcard characters documented by DOS (* and ?). As an alternative, a file containing a list of input files may be supplied. Create a file containing lines with a filename or complete pathname on each line. Provide this filename as the source filename to PCOPY and add an @ character before the name. The list of files will be processed as if they were all specified on the input command line. For filelist processing, PCOPY understands the output of the DOS DIR command. You may use the DOS redirection feature to direct DIR output to a file, edit the file to add or remove entries, and then provide this to PCOPY as input. For example: DIR A: >DIRLIST (edit dirlist) PCOPY @DIRLIST B: Multiple input files may be specified. Separate with commas. I.E. PCOPY *.EXE,*.BAT,*.COM B: [to] Enter the DOS file specification for the directory and filename to be copied to. If the "to" specification is not entered, files will be moved to the current directory. /A Archive - Selects only files that have been marked updated by DOS. This flag is updated by DOS whenever a files is processed with an intent to change or create new data. /AP Append files to target filename. Use to combine several files into one. I.E. PCOPY *.TXT \ALL.TXT/AP 4 /B BACKUP - When specified, the DOS Archive (Update) flag is reset after a file has been copied. /D:[(]xxx Date. Select files based on the relationship between [)] their last update date and the date specified. This [=] parameter includes a date or number of days value. It may also contain a modifier that reverses or modifies the use of the date specified. When xxx contains a date the date is compared to the last update date of the file. The last update date of the file is the date contained in its directory entry. The file is selected if the condition specified by the condition modifier is met. The condition modifier meanings are: '(' Select files whose date is older than the date specified. ')' Select files whose date is newer than the date specified. '=' Select files whose date is equal to the date specified. If the condition modifier is not specified, ')' is assumed. Date values may be specified in any of the following formats: MM/DD/YY MM-DD-YY DDMMMYY 12/31/80 12-31-80 31DEC80 If xxx contains a numeric value, that positive number is used to calculate a date value a number of days prior to the current date. Then that date is used as in the calculation above. Example: /D:(1JAN86 - Process files updated before 1JAN86 /D:)1JAN86 - Process files updated after 1JAN86 /D:=1JAN86 - Process files updated 1JAN86 /D:(5 - Process files modified prior to 5 days ago /D:)5 - Process files modified within the last 5 days /D:=5 - Process files modified 5 days ago /D- Delete all files on target drive before starting copy. 5 /DC Directory Copy - When specified, the file is copied to a directory with the same name on the target disk volume. See also the /S option. This is useful for copying all files and directories from one disk to another. If the target directory does not exist it will automatically be created. /DL Same as /DC except that only the Last node of the source directory is copied to the target pathname to be generated. /DS Same as /DC except that only the current directory level and all its subordinate levels are copied to the target directory. The target directory may be a pathname with multiple directory levels. In this way, you can copy one directory structure below another directory structure. /E Select and move only files that exist on both the "from" and "to" directories. This causes all duplicate named files to be replaced. /F:file First. Indicates that processing is not to start until the specified full filename is encountered in the scan of the directory. This parameter is most useful in restarting a move or copy from a location where it had previously left off. /FI Fill output disks as efficiently as possible. Normally files are copied in the sequence they are found in the source directory. If a large file cannot be copied onto the output disk, a new disk is requested even though there may be enough space left on the output disk to hold other files to be copied. This parameter causes files to be copied in descending size sequence. When a file cannot fit on the output disk, PCOPY looks for another file that will fit on the disk before changing disks. When a new disk is placed in the drive, PCOPY begins processing the larger files again. Eventually, all files requested will be copied. 6 /IFA:pathname Indicates to check to determine that the source file does not already exist in some alternate directory before processing it. If it does not exist, processing will continue. Use just like IFP specified below. /IFP:pathname Indicates to determine that the source file to be copied already exists in the pathname specified by IFP. If it does exist there, process the file. If it does not exist there skip the file. I.E. PCOPY *.BAT \newdir/IFP:\testdir Copies files from the current directory to \NEWDIR only if each file already exists in \TESTDIR. /L:file Last. Indicates that processing is to stop after the specified full filename is encountered in the scan of the directory. The file specified will be processed if it matches selection criteria. /M Stop screen from scrolling past the end without user intervention (MORE). /ME MErge -- Works like using /U and /X parameter to move most current files from one directory into another. In addition, it deletes all the files that are not moved to the new location. This has the effect of merging the most current files from two directories into a single directory. /MU MUltiple input disk are to be processed. After the first input disk is processed, the user is asked if another disk is to be processed. If Yes is the response, processing will continue like the first volume. 7 /N Only move files that do not already exist on the target directory. (New files). If the file already exists, no attempt will be made to move it and no warning message will be printed. /NP No Pause. Use when you have placed the /P parameter in the DOS environment with the SET PCOPY=/P command and want to override it with no pause. /NW No Windows - Do not use windows during processing. All screen output will be done through standard DOS facilities. /O Omit files from processing. This option reverses the purpose of the source filespec in the command. Instead if selecting those files, all files except those matching the filespec will be selected. /P Pause before each file is moved and ask for approval to process it. /R Replace any duplicate files on the target disk or directory regardless of their dates. /RE REgister the program. Use this option to register your copy of the utility. You will need to have the registration number and code that is sent to you when you ask to be registered. Part of the registration screen also allows you to permanently modify the windows option. If you do not want windows during processing, use this option to change the windows program option. You do not need to be registered to change this information. /RO Read-Only. Normally processing skips files marked with the DOS Read-Only attribute. Using /RO causes Read-Only files to also be selected for processing. /S System -- If a source directory is supplied, that directory and all subordinate directories will be processed. If no source directory is specified, all directories on the disk will be processed. 8 /SA SAve -- Instead of overlaying already existing files with duplicate names, before the new file is copied, the file in the target directory is renamed with a version. This insures that no data is lost. If the file has an extension name, the last two characters of the extension are replaced with a number from 01 to 99 depending on the next available number. PCOPY determines the next available number by looking in the directory for other files with similar names. This facility can be used to easily save versions of a file in a directory. /SF System Files. Normally processing skips files marked with the DOS System attribute. Using /SF causes System files to also be selected for processing. /SZ: [(] [)] nnn Select a file based on its size. The left paren indicates that files less than the indicated size are to be selected. The right paren indicates to select files greater than the size. If right or left paren are not specified, a left paren is assumed. Following are examples. /SZ:100 -- Select files less than 100 characters /SZ:(100 -- Select files less than 100 characters /SZ:)100 -- Select files greater than 100 characters /T Test the move process. Use this switch when you would like to test the PMOVE command entered without actually moving any files or creating any directories. Messages will indicate what will happen if the command is executed without the /T switch. /TF Test First. Works like the /T parameter but after test processing is complete, PCOPY will ask you if the command is to be executed as if the /T parameter were not present. If Y is responded, the command will be executed and files will actually be processed. 9 /U Only move files that do not exist on the target directory or duplicate filenames that are newer than their counterparts on the target directory or disk. Use of this option results in the most current version of each selected file being at the target location. /V Verify -- Use the DOS verify option while copying data. This causes all data to be reread after it is written to disk to insure it was written properly. /WH PCOPY will indicate to you WHy files did not get processed. Normally PCOPY will not tell you why or when if a file is bypassed. /X Move the files. Delete them after the copy is performed. If the move is to another directory on the same disk the directory entry for the file is moved without having to move the data. This provides for the fastest move possible. Used for PCOPY only. Specification of default parameters Default parameters are parameters that do not need to be specified each time PCOPY is started. Any PCOPY parameter may be specified as a default parameter. Use the DOS SET command to specify the parameter name and contents to be used by PCOPY each time it is started. The following example indicates that PCOPY is always to assume /U and /NW are specified: SET PCOPY=/U/NW Once this DOS command is issued, each subsequent use of PCOPY will operate as if these parameters have been specified on the command line. The SET command is most commonly placed in the AUTOEXEC.BAT file so it may be in effect every time your machine is started. 10 Examples: 1. Copy all files in directory \GEN to directory \SAVE PCOPY \GEN \SAVE 2. Copy all files in directory \GEN to directory \SAVE PCOPY \GEN \SAVE /C 3. Copy all *.BAT files from current directory to \SAVE PCOPY *.BAT \SAVE or PCOPY *.BAT \SAVE\*.* 4. Move all files in current directory to disk in drive A: PMOVE *.* A:/X 5. Update directory PAY with more current files from drive A:. Save any old versions under generated version name. PCOPY A:*.* \PAY /R/SA 6. Search hard disk C: for any files ending with .WKS and move all the files to a new directory named \WKSDIR. PCOPY c:*.* c:\WKSDIR /X/S 7. Copy all the files on the hard disk to multiple floppy disks to be mounted in drive A:. PCOPY *.* a: /S 11 Program Maintenance: Version 1.0 -- Multiple file move/copy utility with /U /N and /R parameters. Version 2.0 June 1986 -- Added ability to create directory and detect full disks. Version 3.0 August 1986 -- Window operation added. -- Improved help. -- /B /DC /D- /E /RE /S /SA /SF /V Version 4.0 August 18, 1986 -- /ME /SF /RO parameters added. -- Corrected problem with /DC parameter and directory scanning. Version 5.0 October 13, 1986 -- Corrected /B parameter to reset backup directory indicator after file is processed. -- Added /MU parameter to process multiple input disk volumes. -- Various documentation corrections. Special thanks to Edward Koch for technical editing of the document. -- Correct /ME parameter. Merge was deleting the target file, not the source. -- Added selection by size with /SZ:nnn -- Suspend and execute a DOS command from any question or prompt. Press <F3> to accomplish this. This is particularly useful to format new floppy disks when new ones are needed. 12 -- Process a directory tree if /S is specified and a directory name is supplied in the source specification. Previous releases would only process a single directory, without /S, or the entire disk with the /S parm. Version 5.1 November 5, 1986 -- Added complete capability to rename files using DOS global characters ? and * in source and target specification -- Extended ability to copy and create new directories. 1. Allow to copy a directory structure below another structure. If directory copy specified /DC and the target directory also has a pathname, the source pathname is added to the target pathname. 2. Ability to copy a single directory node below an already existing directory structure. Use /DL. 3. Ability to copy a complete directory substructure with a single command. -- Problem corrected where ending totals were not updated after last file copied. -- When /R (replace) specified, print messages indicating if processed files are newer, older or duplicates of overlaid files. Version 6.1 June 27, 1987 -- Added /IFP and IFA command line parms to control file selection based on a duplicate filename being present or absent in another directory. -- Added /WHy parameter to cause PCOPY to show why files were not copied. -- Added /NS to allow PCOPY to run with No Sounds (Beeps) -- Added /BA to allow PCOPY to be used without intervention in DOS .BAT files. The keyboard buffer is not checked for a key to stop processing so keyfake can be used and a no windows mode is used. 13 -- Dressed up the help screens -- Additional message to indicate files skipped due to command parameter options. -- A SET PCOPY= environment specification may be specified with command parameter variables to allow you to have parameters active during every use of PCOPY without having to specify them. Example: SET PCOPY=/WH/U/NW -- When large files are being copied PCOPY will now show the number of characters copied as the file is processed. This is in window mode only. -- Shows date and time for each file copied -- No window mode now shows count of files processed Version 6.2 June 29, 1987 -- Corrected problem causing system hangup when moving files over 64k in size with no window mode. Version 6.4 September 7, 1987 -- PCOPY was rejecting a move request to the same disk when there was less free space on the disk than was the size of the file. The disk space was not actially needed because the file was going to be moved. Corrected. Version 6.5 September 14, 1987 -- When long target pathnames were specified and a replace message was displayed for the user, the system would lock up after getting the users response. This was due to the message area being too short to handle the long pathname. This has been corrected. -- /NP parameter added so users coupd put the /Pause parameter in their environment variable and still override it when needed. /NP = No Pause -- When in windows mode, intercept the DOS interrupt handler to neatly display a window with RETRY CANCEL FAIL ABORT failed I/O attempt. 14 -- If the user has already been asked if it is ok to replace a duplicate filename, and the /Pause parameter is specified, there is no need to pause to ask the user to confirm the process reqyest. Corrected. Version 6.7 October 26, 1987 -- F3 key to exit to DOS was locking up the system when used in non-windows mode. Corrected. -- Some messages were incorrectly wrapping the screen when displayed. Version 7.0 February 22, 1988 -- /FI parameter added to FIll output disks most efficiently. This process moves largest files first, followed by smaller files until a disk is full or no files remain to be copied that can fit on the output disk. -- /DS added. Like /DC, only the directory and all its subordinates are copied below the specified target directory specification. This allows directory structures to be moved below other directory structures. -- /TF command parameter added. This causes PCOPY to ask if the live command is to be started after a test is completed. Good for .BAT files. -- Dates containing a '/' character were not accepted as valid dates. Corrected. -- When a directory name without filename pattern was specified as the /DC parameter was specified to copy directorys to the target, the resulting directory was created without the first character of the directory name. Corrected. -- PCOPY locked the system if a command was entered that contained an error. -- The border color is no longer set as it caused CGA users problems. -- /D- parm to delete all files on target drive did not work when target drive letter is larger than B: 15 Version 7.1 March 16, 1988 -- FIX - /Omit parameter did not work when /S was also used Version 7.2 March 25, 1988 -- FIX - Systems locked up when /FIll parameter was used and a file of zero length was encountered. -- Added capability to process a list of files by specifying an input filename as a list file. Precede with @. Version 7.3 April 20, 1988 -- If source file to be copied has the hidden or system attribute make sure the target file also has that attribute. Version 7.4 May 15, 1988 -- Improve message printed when exact duplicate files are found. Show date/time/size of both files to allow user to easily select file to be processed. -- Allow multiple input file specifications to be supplied on source specification. Separate each with a comma. for example: PCOPY *.BAT,*.EXE,*.COM \UTIL -- Added /AP parameter to allow multiple files to be combined into one file. The target file is not overlayed or replaced. The source data is added to it. Version 7.5 May 29, 1988 -- If /S parameter was specified with a filename without wildcard characters, directories other than the current directory would not be searched. -- The /L: and /B: first file and last file parameters were updated to allow wildcard characters to be specified. 16 Registering PCOPY ----------------- PCOPY is distributed under the Shareware concept. This makes it available for anyone to try without obligation. If you decide it is useful and want to keep it, I ask that you register your use of it. This will allow for continued support and maintenance of the program and will help to encourage that more quality software be made available through this channel. We require all corporate and government users of this utility register their copies. To simply register the program, $15 is requested. If you would like the newest program disk and a copy of the manual send $30. If you would like to register all the Patriquin utilities, and receive programs on disk and manuals, send $45. Send registration requests to: Norm Patriquin P.O. Box 8263 San Bernardino, CA 92412 The registration charge is a one time fee that entitles you to all future versions of the product. These may either be obtained from normal Shareware sources or directly from me. Any organization ordering more than 100 copies is also entitled to telephone support and will be given the technical support number. User groups may license PCOPY, or any other Patriquin utility, for a one time charge of $250. This gives every member of the user group the rights to use PCOPY. Contact Norm Patriquin for more information regarding this offer. Following is a form that may be used to register PCOPY. 17 PCOPY Registration Version 7.5 Please Register PCOPY to the following person. We will use ____ copies of the program and have enclosed $____ for each copy to be used. ************************************************************** _____ Registration code and serial number............ $15.00 _____ Registration, program disk and manual.......... $30.00 _____ Registration of all Patriquin Utilities with program disks and manuals................... $45.00 _____ Update of newest Patriquin Utility disk with manual (Provide your serial number ________) $15.00 ************************************************************** Name: __________________________________________________ Company: _______________________________________________ Address: _______________________________________________ _______________________________________________ City: ______________________________ State: ___________ Zip: ______________________ I obtained my copy of PCOPY from: ______________________________________________________ If BBS indicate name and number please. ______________________________________________________ Please register the software under the following name: ______________________________________________________ Send to: Norm Patriquin P.O. Box 8263 San Bernardino, CA 92412 18 P C O P Y Version 7.5 Problems and Maintenance ------------------------ I welcome all comments or enhancement suggestions. Please document each item clearly and provide printed examples if possible. Please be sure to include this form with all requests, it will help to make sure we can provide you with the best possible service. For fast support, call Patriquin's BBS at 714-369-9766. Name: __________________________________________________ Company: _______________________________________________ Address: _______________________________________________ _______________________________________________ City: __________________________________ State: _______ Zip: ______________________________ Telephone: _______ / ________________________ (Home / Work) Date: _________________________ Description of problem or enhancement: _________________________________________________________ _________________________________________________________ _________________________________________________________ _________________________________________________________ Suggested solution: _________________________________________________________ _________________________________________________________ 19